home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / MorphOS / Epic4_mos / share / epic / help / 6_functions / insertw < prev    next >
Encoding:
Text File  |  2002-10-28  |  775 b   |  25 lines
  1. Synopsis:
  2.    $insertw(<index> <word> <text>)
  3.  
  4. Technical:
  5.    This function inserts the given word into the given text, in the position
  6.    indicated by the given index.  It returns the resultant string.  The
  7.    index counts from 0 (zero).
  8.  
  9. Practical:
  10.    This function is used when you want to insert a word into an existing
  11.    text string (usually held in a variable).  This could be useful as a
  12.    pseudo-unshift mechanism; using an index of 0 would yield the same
  13.    results as $unshift(), but in truth any offset could be used (thus
  14.    keeping the first few words intact, and unshifting the rest).
  15.  
  16. Returns:
  17.    input text with word inserted
  18.  
  19. Examples:
  20.    $insertw(1 blah hi there bob)       returns "hi blah there bob"
  21.  
  22. See Also:
  23.    remw(6); unshift(6)
  24.  
  25.